Release 10.1A: OpenEdge Deployment:
WebClient Applications

Handling errors

If the application uses URLs in the PROPATH, the application is responsible for handling all errors, which might involve URLs, connections, and authentication.

URL specification errors

If the PROPATH contains an ill-formed URL (for example, one with the percent symbol (%), which is not allowed), the following processing occurs:

When the URL is not a fully qualified path, SEARCH() and LOAD–IMAGE() do not raise an error, skip the URL, and continue searching with the next entry in the PROPATH.
When the URL is a fully qualified path, SEARCH() and LOAD-IMAGE() raise an error.

Connection errors

If the PROPATH contains a correctly formed URL but the connection to the Web server fails, the following processing occurs:

When the URL is not a fully-qualified path, SEARCH() and LOAD–IMAGE() do not raise an error and searching continues with the next entry in the PROPATH.
When the URL is a fully-qualified path, SEARCH() and LOAD-IMAGE() raise an error.

Authentication errors

If an application uses SEARCH() or LOAD–IMAGE(), the PROPATH contains a URL, and authentication on a Web server fails, the following processing occurs:

When the URL is not a fully qualified path, SEARCH() and LOAD-IMAGE() do not raise an error and searching continues with the next entry in the PROPATH.
When the URL is a fully qualified path:
The SEARCH() function does not raise an error but returns the Unknown value (?).
The LOAD–IMAGE(), LOAD–IMAGE–DOWN(), LOAD–IMAGE–UP(), LOAD–IMAGE–INSENSITIVE(), and LOAD–ICON() methods raise error 9368, where server-name is the host name of the Web server, as shown:

Unable to download file from the web. Authentication failed for server server-name.

You can trap this error, request a user ID and password, and try to download the image again, as in the following example:

DEFINE BUTTON Button1. Button1:LOAD-IMAGE    ("http://userid:password@www.progress.com/myimage.jpg") NO-ERROR. IF ERROR-STATUS:GET-NUMBER(1) = 9368 THEN DO:    /* Display dialog. */    /* Update URL string. */    /* Retry load-image. */ END.